<HTML><HEAD><TITLE>set_var_name_counter(++BaseName, ++Start)</TITLE>
</HEAD><BODY>[ <A HREF="index.html">library(var_name)</A> | <A HREF="../../index.html">Reference Manual</A> | <A HREF="../../fullindex.html">Alphabetic Index</A> ]
<H1>set_var_name_counter(++BaseName, ++Start)</H1>
Set the initial value for the counter for variable name BaseName.
<DL>
<DT><EM>BaseName</EM></DT>
<DD>A valid base-name (atom or string)
</DD>
<DT><EM>Start</EM></DT>
<DD>Start value for counter (integer)
</DD>
</DL>
<H2>Description</H2>
    <P>
	Set the initial counter value for a variable name BaseName that will
        then be used in set_var_name/2, with Start as the initial value of 
        the counter. If BaseName already exists (i.e. variables have already
        been named using BaseName), the predicate will fail.

    </P><P>
        It is expected that the main use of this predicate will be to change
        the default counter start value from 0 to 1. However, no restrictions 
        are placed on what the start value may be.

<H3>Fail Conditions</H3>
BaseName already exists.
<H3>Resatisfiable</H3>
no
<H3>Exceptions</H3>
<DL>
<DT><EM>(5) type error </EM>
<DD>BaseName is not an atom or string.
<DT><EM>(5) type error </EM>
<DD>Start is not an integer.
<DT><EM>(6) out of range </EM>
<DD>BaseName does not begin with a capital letter.
</DL>
<H2>See Also</H2>
<A HREF="../../lib/var_name/set_var_name-2.html">set_var_name / 2</A>
</BODY></HTML>
